home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 3 #4 / IMG 26 April 1995.iso / More Goodies / All Things Marathon / Marathon Editors / Mara. OPE 1.3 / OPE ReadMe next >
Text File  |  1995-03-18  |  12KB  |  283 lines
  1. Object Placement Editor (formerly NetEdit) v1.3
  2. By Eric Bennett (ericb@psu.edu)
  3.  
  4.  
  5. ==============================================================================
  6. General
  7. ==============================================================================
  8.  
  9. Have you played Marathon over the network enough times that you're sick
  10. of seeing the same aliens repeatedly?  This program allows you to change:
  11.  
  12. -how many aliens/objects of each type are initially present on a level
  13. -how many aliens/objects of each type are present during play
  14. -whether aliens/objects are placed randomly or in specific locations
  15. -how often aliens are added
  16.  
  17. OPE includes a randomizer for quickly resetting all of the above parameters
  18. for any given level.
  19.  
  20. Although these changes are primarily useful for modifying net play, you can
  21. also use this program as a cheater in the regular game by adding objects
  22. or removing aliens.
  23.  
  24. ==============================================================================
  25. License and (lack of) Warranty
  26. ==============================================================================
  27.  
  28. This program is freeware.
  29.  
  30. The author (Eric Bennett) in no way warrants that the program will perform
  31. as described in this manual (or any other document).  USE THIS SOFTWARE
  32. AT YOUR OWN RISK!
  33.  
  34.  
  35. ==============================================================================
  36. Distribution
  37. ==============================================================================
  38.  
  39. You may redistribute this program provided that you include the original,
  40. unmodified application and readme files and NOTHING ELSE.  You may charge
  41. duplication fees for distributing this program, but your fee may not exceed
  42. the basic cost of media duplication (you may place this program on an online
  43. service as long as downloading the file incurs only standard connection
  44. charges).  
  45.  
  46. DO NOT DISTRIBUTE OBJECT PLACEMENT EDITOR (OPE) TO THE FOLLOWING SITES:
  47. sumex-aim.stanford.edu
  48. ftp.amug.org
  49. America Online (Macintosh Games Forum)
  50.  
  51. I will update these three sites myself, so please don't send them extra copies.
  52.  
  53.  
  54. The author specifically grants permission to the maintainers of the
  55. archives at Sumex-Aim.stanford.edu to include this program on the CD-ROM
  56. distribution of the archive.
  57.  
  58. The author specifically grants permission to SOFTBANK Corporation to include
  59. this program on its supplemental applications disk bundled with MacUser
  60. Japanese Edition.
  61.  
  62. ==============================================================================
  63. How to get new versions
  64. ==============================================================================
  65.  
  66. I will post release versions to sumex-aim.stanford.edu, America Online (Mac
  67. Games Forum) and ftp.amug.org.  You can get releases and prereleases (not
  68. for redistribution) from one of my web pages:
  69.  
  70. http://www.amug.org/~marathon/ope/
  71. http://emb121.rh.psu.edu/marathon/marathon.html
  72.  
  73.  
  74. ==============================================================================
  75. Special Considerations--READ BEFORE USING!
  76. ==============================================================================
  77.  
  78. You should NEVER have to change the amount of memory allocated to OPE in the
  79. Finder.  As of version 1.21b, OPE uses a new memory management method.  If
  80. OPE needs more memory, it will obtain it from the system software.  In other
  81. words, if you open a 3.5 meg map file and OPE has only its standard 280k of
  82. memory, your system software will expand to use an additional 3.5 megs of
  83. RAM.  "About this Macintosh..." under the Apple menu in the Finder will
  84. reflect this increase in memory use.  As soon as you close your file in OPE,
  85. the memory will be released for use by other applications.
  86.  
  87. You should be able to use maps from the Demo or the commercial release. If the
  88. format of your map file is not the same, this program will probably corrupt it.
  89.  
  90. EDIT ONLY A BACKUP COPY OF YOUR MAP FILE.  This program is not based on solid
  91. information from Bungie; it uses information uncovered by Tom Klancer and
  92. myself.  Don't trust this program to work.
  93.  
  94. I have encountered occasional problems when net players are not using the map
  95. file.  In most cases nothing goes wrong since Marathon transfers the
  96. gathering machine's copy of the map to the other machines, but if your
  97. net games crash with a modified map you might try giving the modified
  98. map file to all of the other players.
  99.  
  100.  
  101. ==============================================================================
  102. How to use OPE--Basic Editing
  103. ==============================================================================
  104.  
  105. After loading OPE, select "Open..." from the file menu and load your map (you
  106. can also drag-and-drop a map from the Finder).  OPE will scan the file for
  107. valid levels.
  108.  
  109. Now select the desired level under the "Levels" menu.
  110.  
  111. You can select which character/object you wish to edit by selecting it from
  112. the "Characters" or "Objects" menus.  In the main window, there are four
  113. edit fields:
  114.  
  115. -Placement method
  116.         If you place a 1 here, objects will be placed randomly on the level.  
  117.     Net levels work in this way.  Regular game levels have a zero, meaning that
  118.     aliens are placed in specific places on the level.  Changing the default
  119.     value on a given level from 0 to 1 should not cause problems, but I don't
  120.     know how Marathon responds when directed to placed objects in specific
  121.     locations when they're usually random.
  122.         If you use a value other than 0 or 1, NetEdit uses a 1 because 1 is
  123.     guaranteed to work.
  124. -Initial # of object
  125.         The object will be placed this many times on the level before game
  126.     play begins; objects are placed depending on the value of the first field.
  127. -Minimum #
  128.         Marathon will do its best to keep this amount of the object in play.
  129.     However, if you have nonrandom placement (first field) on and you ask for
  130.     more objects than the map has placement positions, Marathon may not be
  131.     able to replenish fast enough.
  132. -Max #
  133.         This represents the total number of the alien or object that can be
  134.     present on the level at once.  For example, a value of 10 in the record
  135.     for napalm canisters means that at most 10 canisters can be in play (held
  136.     by players or sitting on the floor) at any one time.  Or, suppose Min# of
  137.     missiles is 4 and Max# is 8; there will always be 4 missile packs in play,
  138.     and there may be up to 8 (although Marathon is _very slow_ to increase
  139.     the number of objects from min# to max#).  Note also that if Min# is
  140.     greater than Max# then Max# is irrelevant.
  141. -Extras
  142.         The total number of objects which Marathon will add over the course of the game
  143.     in addition to the minimum number which must always be there.  An example explains
  144.     this better: suppose Min# fighters is 2, Max# is 4, Extras is 10.  There will
  145.     always be at least 2 fighters; fighters will be added until up till four are present,
  146.     but only ten times--after this only the two required fighters will be present. Or
  147.     you can think of the Min# field as having precedence over the Extras field. 65535
  148.     supposedly represents infinite replenishment (as if anyone would play long enough
  149.     to exhaust 65534 items...).
  150. -Replenishment freq.
  151.         The higher the number, the more often Marathon will add the object in an attempt
  152.     to reach Max#.  Values are from 0-65535.
  153.  
  154. If you want none of an object, set both min# and max# to zero.
  155.  
  156. If you enter a value less than 0 or greater than 255 for Initial# or Max# or Min#, OPE
  157. will substitute ZERO.
  158.  
  159. To clear all characters or objects from the level, choose "Remove all aliens"
  160. or "Remove all objects" from the special menu. "Clear All Records" does both.
  161.  
  162.  
  163. ==============================================================================
  164. How to use OPE--Level Randomizer
  165. ==============================================================================
  166.  
  167. The Randomizer (in the Special Menu) is a quick way to generate new net 
  168. levels.  It clears all objects from the current level and then places
  169. new ones based on what frequency of the various type of objects you choose
  170. in the Randomizer window.
  171.  
  172. Some things you should be aware of:
  173. 1).  OPE usually instructs Marathon to place weapons in their predefined
  174.     locations, but if a level doesn't have a predefined spot for a weapon,
  175.     it will never appear.  To circumvent this problem you can check the
  176.     "Place weapons randomly" checkbox in the Randomizer window.
  177. 2).  Because randomly placing large aliens (juggernauts and, to a lesser
  178.     extent, hulks) can cause problems in levels with small closed spaces,
  179.     OPE instructs Marathon to place these aliens only in predefined map
  180.     locations (if the map contains no starting points for hulks and
  181.     juggernauts, none will appear).  If you really want these aliens
  182.     to appear randomly like everything else, you can make a really simple
  183.     change OPE with ResEdit; see the "How OPE Works" file for instructions
  184.     on how to make the change (it's easy--honest!).
  185.  
  186.  
  187. ==============================================================================
  188. About the Included Files (in the "File Formats" directory)
  189. ==============================================================================
  190.  
  191. "How OPE works"            describes what I know about the "plac" section and
  192.                             tells you how to use ResEdit to customize
  193.                             OPE for new objects or to change the behavior
  194.                             of the Randomizer.
  195. "Map Editing"            a somewhat dated file with info on the map file
  196.                             (I did _not_ write this file)
  197. "Marathon File Specs"    file format info for several of Marathon's files.
  198.                             (I did _not_ write this file)
  199.  
  200.  
  201. ==============================================================================
  202. Version History
  203. ==============================================================================
  204. 03/18/95 -- version 1.3
  205.             the map file is now loaded into the system heap
  206.             added a portion of code which had miraculously vanished since
  207.                 version 1.12b--"Place weapons randomly" in the randomizer
  208.                 dialog
  209.             added level-scanning thermometer
  210.  
  211. 03/15/95 -- version 1.2
  212.             Added (yuck) custom icon; many people bugged me to use one :(.
  213.             Started checking for changes to the open file before closing it.
  214.             Added file open via drag-and-drop in the Finder.
  215.             Opened last two fields for editing.
  216.             Added level randomizer.
  217.             Added load/save/search cursor changes.
  218.             Changed (again!) fields descriptions.
  219.             You can now navigate edit fields with return, tab, and up/down.
  220.  
  221. 02/21/95 -- version 1.1.
  222.             Added editing of objects (added the "Objects" menu).
  223.             Fixed possible crash when Opening a locked file (Save still bombs).
  224.             Included information on Marathon file formats.
  225.             Added "Placement Method" field.
  226.         
  227. 02/11/95 -- version 1.0
  228.                First version; known as NetEdit.
  229.                Written in about 6 hours and possibly buggy :)
  230.      
  231.      
  232. "Fake" problems with OPE:
  233.  
  234.     - Early versions (0.5, 0.6) of the Mia! map editor alter the map file
  235.       so that OPE is unable to find the correct level names.  This was a
  236.       bug in Mia! and is fixed in Mia! v0.62.
  237.      
  238.      
  239. What may appear in future releases:
  240.  
  241.     - decent error handling (currently, OPE bombs on locked files etc.)
  242.     - a window containing a summary of all objects currently on the level
  243.            being edited
  244.     - pictures of the aliens and objects
  245.     - a more intelligent randomizer
  246.     - a faster algorithm for finding level offsets
  247.  
  248.  
  249. What will NOT appear in future releases:
  250.  
  251.     - full-fledged map editing
  252.  
  253.  
  254. ==============================================================================
  255. HOW TO REPORT BUGS
  256. ==============================================================================
  257.  
  258. If you find a bug, please figure out how to reproduce it, then send me a bug
  259. report at any of the following email addresses:
  260.  
  261. Marathon@emb121.rh.psu.edu   (fastest response during fall/spring semester)
  262. EricB@psu.edu                (guaranteed to reach me any time of year)
  263. EricB888@aol.com             (I don't read this often)
  264. emb121@psuvm.psu.edu         (I almost *never* read this)
  265.  
  266.  
  267.  
  268. ==============================================================================
  269. Special Thanks
  270. ==============================================================================
  271.  
  272. Thanks go to:
  273.  
  274. -Tom Klancer     : provided some information on the map file format.
  275. -Bungie Software : created Marathon :).
  276. -Zedcor, Inc.    : published my S'pht, FutureBasic 1.0.3.
  277.  
  278. Less specifically, thanks to everyone on the 'net who sent me suggestions for
  279. new features and icons etc.
  280.  
  281.  
  282. [end of file]
  283.